home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1996 #14 / Monster Media No. 14 (April 1996) (Monster Media, Inc.).ISO / spitfire / sfadv10.zip / SFADV.DOC < prev   
Text File  |  1996-01-21  |  7KB  |  154 lines
  1.                             SFAdvisor v1.0
  2.  
  3.       A Freeware Spitfire BBS Security Level Info Screens Generator
  4.  
  5.                     (c) 1996 by Robert G. Schiele
  6.  
  7.                        May be distributed freely.
  8.  
  9.  
  10.  
  11. Installation:
  12. ────────────
  13.  
  14.         The archive containing the SFAdvsior files can be unpacked into any
  15. directory you choose. An SFADV.CFG file must be reside in the same
  16. directory, and the program must be run from this directory. The
  17. configuration file MUST be named SFADV.CFG, but need not be mentioned when
  18. SFAdvisor is run. The program is invoked by simply typing SFADV from the
  19. DOS command line, or from a batch file.
  20.  
  21. Configuration:
  22. ─────────────
  23.  
  24.         A sample configuration file is provided that works with my own
  25. system. It is probably self-explanatory, but in any case, has to be setup
  26. as follows:
  27.  
  28. LINE1 Your BBS's Name
  29. LINE2 Path (including drive, but NOT filename or extension) to your
  30.       DAILYLMT.DAT file
  31. LINE3 Path (including drive, but NOT filenames or extensions) to your
  32.       Spitfire display files
  33.  
  34. That's all there is to it. The example configuration that I use on my own
  35. system is reprinted here below:
  36.  
  37. The Programmer's Corner BBS
  38. C:\SF\
  39. C:\SF\DISPLAY\
  40.  
  41. There should be no blank lines at the beginning or at the end of this file.
  42. It may be created with any ASCII text editor you like.
  43.  
  44. How SFAdvisor Works:
  45. ───────────────────
  46.  
  47.         SFAdvisor, once installed and configured correctly, will simply
  48. read your DAILYLMT.DAT file, and then create ANSI (.CLR) and ASCII (.BBS)
  49. files with the XXXSEC.BC format that will be displayed each time a caller
  50. logs on your BBS. The caller is shown only the screen that is appropriate
  51. to their security level and type of display. For instance, say you have a
  52. security level on your BBS of 10 (possibly among others). After you're run
  53. SFAdvisor, you'll have two screens (with others as well) that are titled
  54. 10SEC.CLR and 10SEC.BBS in your SF display directory. Each level 10 caller
  55. will be shown either the 10SEC.BBS or the 10SEC.CLR file (depending on
  56. whether their display supports ANSI or not) one time, each time they log on
  57. your BBS.
  58.  
  59.         As SFAdvisor runs, it shows you the contents of your DAILYLMT.DAT
  60. file as well, giving you an opportunity, if you need to, to review exactly
  61. what access levels you are currently supporting, and what their limitations
  62. are. Personally, I find this useful, as the DAILYLMT.COM program that
  63. creates this file, that is provided with Spitfire, does not show the
  64. information in a format that is as easy, for me at least, to read.
  65.  
  66.         If anything goes wrong, for instance, if you have a blank line
  67. in the SFADV.CFG file instead of your BBS's name, or else you have an
  68. invalid path included in the file, or if SFAdvisor can't find your
  69. DAILYLMT.DAT file, the program will tell you what's wrong, then halt
  70. without creating anything.
  71.  
  72. Why SFAdvisor:
  73. ─────────────
  74.  
  75.         I wrote SFAdvisor because I like to show callers exactly what
  76. privileges I'm allowing them when they log on. Spitfire shows them some
  77. information, by itself, but not as complete as I'd like. It's possible (not
  78. even difficult, if you'r proficient at creating ANSI screens using an ANSI
  79. editor) to create similar screens on your own, manually. But, if you do
  80. that, there is information that you have to manually insert, often
  81. different for each level, from your DAILYLMT.DAT file, such as MPD (how
  82. many minutes per day the caller is allowed), and whether or not there is a
  83. file ratio in effect for their access level, and if so, exactly what that
  84. might be. When and if you change your access levels, you then, if you do it
  85. manually, have to go back and manually change all your screens. If you
  86. support several access levels, this can be time-consuming. SFAdvisor
  87. automates the whole process, and does it within seconds.
  88.  
  89. Licensing:
  90. ─────────
  91.  
  92.         SFAdvisor is provided to you as freeware, which means you don't
  93. owe me (or anybody else!) any money for the privilege of using it. You are
  94. automatically licensed to operate SFAdvisor on as many computers as you
  95. want, for as long as you want.
  96.  
  97. Disclaimer:
  98. ──────────
  99.  
  100.         I make absolutely no representations that SFAdvisor will do
  101. anything except take up space on your hard drive. Every reasonable
  102. precaution (consistent with good programming practices) has been taken to
  103. make SFAdvisor safe to operate, however, if you do choose to use SFAdvisor,
  104. you do so entirely at your own risk. I will not be responsible for any
  105. consequential damages, lost time, or anything whatsoever, arising from the
  106. use of SFAdvisor. It works fine for me, on my own BBS. And I've tried, in
  107. creating it, to simulate every possible error another user might commit
  108. while running it, however, that does not mean that I can be positive that
  109. it'll work for you. If you run it and like it, fine: you're free to use it
  110. as long as you want. If you run it and don't like it or can't get it to
  111. work, then don't use it.
  112.  
  113. Support:
  114. ───────
  115.  
  116.         I can be reached for questions or comments regarding SFAdvisor (or
  117. any of my other freeware software programs) via Internet email at:
  118.  
  119.                         <schiele@inetdirect.net>
  120.  
  121. I can also be reached via "snail mail" at:
  122.  
  123.                         Robert Schiele
  124.                         927 N. Pennsylvania
  125.                         Indianapolis, IN., 46204
  126.  
  127. Finally, you can always call my BBS, the Programmer's Corner BBS, at (317)
  128. 639-6796, from 3:00 PM until 12:00 Midnight (E.S.T.) seven days a week.
  129. There, you'll always find the latest version, in case I ever decide to
  130. upgrade the software.
  131.  
  132. Credits:
  133. ───────
  134.  
  135.         SFAdvisor was programmed entirely in Microsoft's QuickBASIC 4.5,
  136. then complied and liked using Ethan Winer's excellent PDQ linking library.
  137. This accounts for the program's small size and speed. Several assembler
  138. routines were also utilized from Garry Spencer's (of Spencer Technology,
  139. Memphis, TN) GPS library for QuickBASIC, which he has generously provided
  140. as freeware.
  141.  
  142.         As always, much, much credit and thanks go to Mike Woltz and
  143. Buffalo Creek Software for the creation and support of Spitfire, for my
  144. money, the very best BBS software yet written for the PC. Quite obviously,
  145. without him and his first-rate programming skills, none of the rest of us
  146. would be writing Spitfire utilities.
  147.  
  148. "Spitfire" and "DAILYLMT.COM" are (c) Mike Woltz and Buffalo Creek Software
  149. "PDQ" is (c) Ethan Winer and Full Moon Software
  150. "GPS" is (c) Garry Spencer and Spencer Technologies
  151. "QuickBASIC 4.5" is (c) Microsoft Corportation
  152.  
  153.  
  154.